home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / onerun32.zip / ONERUN.DOC < prev    next >
Text File  |  1992-10-12  |  10KB  |  247 lines
  1.  
  2.                        ============================
  3.                                  OneRun!
  4.                        ============================
  5.                         (c)1990,91,92 T&J Software
  6.  
  7.         One of the T&J Software Collection of multi-BBS door programs.
  8.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  9.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  10.  
  11.                        VERSION 3.2      10/12/92
  12.  
  13.                                    By
  14.  
  15.                                Tom Wildoner
  16.                              397 West Broadway
  17.                               Jim Thorpe, PA
  18.                                   18229
  19.                             VOICE (717)325-9480
  20.                    *between 5:30 & 10:00 p.m. Eastern Time
  21.  
  22.                                   From
  23.  
  24.                                The T&J BBS
  25.                               (717)325-9481
  26.                         1200/2400/9600/19200/38400
  27.                                24 Hours/Day
  28.  
  29. LEGALITIES:
  30. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  31. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  32. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  33. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  34. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  35. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  36.  
  37. DISTRIBUTION:
  38. You may make this file available for downloading from your BBS or you may
  39. upload it to any BBS of your choice, provided that you do not make any
  40. changes to the contents of the archive (ZIP file). The archive and its
  41. individual contents may not be used by any service that charges any money
  42. whatsoever, without the written permission of the author.
  43.  
  44. PROGRAM DESCRIPTION:
  45. ====================
  46.  
  47. ONERUN was made to help compliment other T&J Software doors games and
  48. future utility programs. It allows you, the SysOp, to set up door games
  49. or other door programs for limited access during the day.
  50.  
  51. ONERUN creates a small player record file which contains the players name,
  52. date, and number or plays during that day. This file is checked during
  53. each play and the number of plays is adjusted. If you say the player can
  54. only enter your door twice per day, OneRun will only allow him to enter
  55. twice per day.
  56.  
  57. CONFIGURATION:
  58. =============
  59.  
  60. Example configuration file for PCBOARD.SYS
  61. ------------------------------------------
  62.  
  63. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  64. T&J Software        <=-  (Change this to your BBS name)
  65. Tom                 <=-  (The Sysop's first name)
  66. Wildoner            <=-  (The Sysop's last name)
  67.  
  68. Example configuration file for USERS.SYS
  69. ----------------------------------------
  70.  
  71. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  72. T&J Software        <=-  (Change this to your BBS name)
  73. Tom                 <=-  (The Sysop's first name)
  74. Wildoner            <=-  (The Sysop's last name)
  75.  
  76. Example configuration file for DOOR.SYS
  77. ---------------------------------------
  78.  
  79. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  80. T&J Software        <=-  (Change this to your BBS name)
  81. Tom                 <=-  (The Sysop's first name)
  82. Wildoner            <=-  (The Sysop's last name)
  83.  
  84. Example configuration file for USERINFO.DAT
  85. -------------------------------------------
  86.  
  87. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  88. T&J Software        <=-  (Change this to your BBS name)
  89. Tom                 <=-  (The Sysop's first name)
  90. Wildoner            <=-  (The Sysop's last name)
  91. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  92.  
  93. Example configuration file for CALLINFO.BBS
  94. -------------------------------------------
  95.  
  96. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  97. T&J Software        <=-  (Change this to your BBS name)
  98. Tom                 <=-  (The Sysop's first name)
  99. Wildoner            <=-  (The Sysop's last name)
  100.  
  101. Example configuration file for DORINFOx.DEF
  102. -------------------------------------------
  103.  
  104. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  105.                           where 'x' is the BBS Node number.
  106. T&J Software        <=-  (Change this to your BBS name)
  107. Tom                 <=-  (The Sysop's first name)
  108. Wildoner            <=-  (The Sysop's last name)
  109.  
  110. Example configuration file for SFDOORS.DAT
  111. ------------------------------------------
  112.  
  113. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  114. T&J Software        <=-  (Change this to your BBS name)
  115. Tom                 <=-  (The Sysop's first name)
  116. Wildoner            <=-  (The Sysop's last name)
  117.  
  118. Example configuration file for CHAIN.TXT
  119. ----------------------------------------
  120.  
  121. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  122. T&J Software        <=-  (Change this to your BBS name)
  123. Tom                 <=-  (The Sysop's first name)
  124. Wildoner            <=-  (The Sysop's last name)
  125.  
  126. Example configuration file for GTUSER.BBS
  127. -----------------------------------------
  128.  
  129. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  130. T&J Software        <=-  (Change this to your BBS name)
  131. Tom                 <=-  (The Sysop's first name)
  132. Wildoner            <=-  (The Sysop's last name)
  133. 1                   <=-  (COM port number - defaults to 1)
  134. 1                   <=-  (Node number - defaults to 1)
  135.  
  136. This Door is multi-node  compatible so you may run more than 1 node from
  137. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  138. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  139. variables, (q.v.)
  140.  
  141. Environment Variables
  142. =====================
  143.  
  144. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  145. variables. Non-PCBoard systems may also use these variables by including
  146. the following in either your BBS batch or AUTOEXEC.BAT
  147.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  148.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  149. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  150. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  151. .CFG file for multi-node operation!
  152.  
  153. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  154. command line.  For example:
  155.  
  156.      ONERUN ONERUN.CFG /5
  157. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  158.      ONERUN ONERUN.CFG /%IRQ%
  159.  
  160. This tells the program to use IRQ 5 instead of the standard IRQ.
  161.  
  162.  
  163. Sysop Keys
  164. ==========
  165.  
  166. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  167.          written to DOOR.SYS and USERS.SYS
  168. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  169.          and/or written to DOOR.SYS and USERS.SYS
  170. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  171. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  172.          and/or written to DOOR.SYS and USERS.SYS
  173. F8    -  Returns the caller involuntarily to the BBS.
  174. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  175.          and/or written to DOOR.SYS and USERS.SYS
  176. F10   -  Activates SysOp CHAT mode within the DOOR.
  177. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  178. UP    -  Give the caller extra time while in the DOOR.  
  179. DN    -  Subtract time from the caller while in the DOOR. 
  180. HOME  -  HELP key for Status Line options.
  181. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  182. ALT-X -  PCBoard will exit after current caller logs off. Value is
  183.          passed to PCBoard. Not available on non-PCBoard systems.
  184.  
  185.  
  186.  
  187. ONERUN.SYS
  188.  
  189. 1                 'How many plays per day per player.
  190. "01-20-1992"      'The current date in this format "MM-DD-YYYY"
  191.  
  192.  
  193. ONERUN.DAT -- One run will take care of this file. It's listed here
  194.               so you will know what it contains.
  195.  
  196. 1                           'Number of user records.
  197. "Nobody","01-20-1992",0     'Starting user record.
  198.  
  199.  
  200. How to configure your DOORx.BAT files:
  201.  
  202. CD\WC30\DOOR\LEMON
  203. ONERUN ONERUN.CFG
  204. IF EXIST ONE.RUN GOTO QUIT
  205. LEMON20 LEMON.CFG
  206. :QUIT
  207. DEL ONE.RUN
  208. CD\WC30
  209.  
  210.    LINE 1: Path to your door directory.
  211.    LINE 2: Run your ONERUN program.
  212.    LINE 3: This line is very important. ONERUN creates the file ONE.RUN
  213.            if the user has no more access to the door. This line causes
  214.            the batch file to skip the actual door program if the file
  215.            ONE.RUN was found in the directory.
  216.    LINE 4: Your actual door program (however many lines it takes).
  217.    LINE 5: Line that the batch file will branch to if ONE.RUN is
  218.            found to exist.
  219.    LINE 6: Delete the old ONE.RUN file.
  220.    LINE 7: Return to the BBS.
  221.  
  222.  
  223. To run in LOCAL mode simply enter:  ONERUN LOCAL
  224.  
  225. FUTURE VERSIONS:
  226. ================
  227.  
  228. --->> Let me know what you would like to see!
  229.  
  230. REGISTERING:
  231. ============
  232.  
  233. That's all there is to it! If you have any problems or questions
  234. please feel free to call the T&J BBS at (717)325-9481 and join the
  235. T&J Software Conference. Online ordering using Mastercard or Visa
  236. is available at the T&J Software BBS!
  237.  
  238. BENEFITS OF REGISTERING:
  239. ========================
  240.  
  241. OneRun will normally allow you to specify how many plays per day a
  242. user can play the actual door. This unregistered version defaults to
  243. 1 (line 1 of the ONERUN.SYS file). Registering will allow you to set this
  244. number to anything you wish.
  245.  
  246. See the REGISTER.TXT file for information on registering!
  247.